home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / getdiz12.zip / GET-DIZ.DOC < prev    next >
Text File  |  1993-03-05  |  11KB  |  205 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │ ▒▒▒▒  GET-DIZ v1.2  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  3. └─────────────────────────────────────────────────────────────────────────────┘
  4.  
  5.  
  6.                  Puts FILE_ID.DIZ descriptions in RA 2.00's FDB
  7.  
  8.                              Written by Mike Ehlert
  9.                     (c) Copyright 1992 All Rights Reserved
  10.  
  11.                                    Mike Ehlert 
  12.                    PACIFIC COAST MICRO
  13.                                 1879 Campbell Ave.
  14.                            Thousand Oaks, CA. 91360 USA
  15.  
  16.                 (805) 494-9386 / (805) 497-3456  / (805) 496-7320
  17.  
  18.                                FidoNet: 1:102/1001
  19.  
  20.  
  21. ┌─────────────────────────────────────────────────────────────────────────────┐
  22. │ ▒▒▒▒  What can this do ?  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  23. └─────────────────────────────────────────────────────────────────────────────┘
  24.  
  25.        GET-DIZ is an add-on utility for the RemoteAccess 2.00 File Manager.
  26.        It allows you to quickly scan some or all files in the current area
  27.        for FILE_ID.DIZ or DESC.SDN file descriptions, and each time one is
  28.        found it puts that description into RA's FDB (file data base) even
  29.        if a differnt description already existed there.
  30.        
  31.        DIZ stands for "Description In Zip", and FILE_ID.DIZ descriptions
  32.        were originally use by PCBoard BBS Software. DESC.SDN is a similar
  33.        description file, used by the Software Distribution Network.
  34.  
  35. ┌─────────────────────────────────────────────────────────────────────────────┐
  36. │ ▒▒▒▒  Whats new in version 1.2? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  37. └─────────────────────────────────────────────────────────────────────────────┘
  38.  
  39.       This version is now 4DOS compatible! I had to actually install 4DOS
  40.       on my system to figure out why it was not working, and I fixed it.
  41.       This may also be fully compatible with DOS 3.3 now, although I have
  42.       not had anyone running DOS 3.3 test it yet.
  43.              
  44. ┌─────────────────────────────────────────────────────────────────────────────┐
  45. │ ▒▒▒▒  Whats new in version 1.1? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  46. └─────────────────────────────────────────────────────────────────────────────┘
  47.  
  48.       This version has support for PolyXarc, to support *any* archive type.
  49.       (Thanks to David Gibbs of the Midrange System for the suggestion.)
  50.       The docs now explain how to get around a bug if using DOS 3.3.
  51.       
  52.       ** Notice ** the file names have been renamed in this version!
  53.       Be sure to update raconfig accordingly!
  54.       
  55. ┌─────────────────────────────────────────────────────────────────────────────┐
  56. │ ▒▒▒▒  Required Programs  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  57. └─────────────────────────────────────────────────────────────────────────────┘
  58.  
  59.        GET-DIZ is not a stand alone program, and requires the following
  60.        other programs to properly run:
  61.  
  62.        RAMGR.EXE    (RA Manager which comes with RA 2.00)
  63.        KIS.EXE      (Keyboard Input Simulator by R. van Hoven)
  64.        PKUNZIP.EXE  (Pkunzip by PKware)
  65.        ARJ.EXE      (Arj by Robert K Jung)
  66.        POLYXARC.EXE (*optional* the GET-DIZX.com version can use this
  67.                      which is a slower method but handles all archive
  68.                      types. PolyXarc by Jeffrey Nonken)
  69.        
  70.        RAMGR is required since this is an add-on for it which is designed
  71.        to be only called from RAMGR.EXE directly.
  72.  
  73.        The reason that KIS is needed is to stuff keys into the keyboard
  74.        buffer before returning to RAMGR, to force RAMGR to perform the FDB
  75.        updates and to force GET-DIZ to be called again for the next file(s).
  76.        You can freq. or download the latest KIS from any DISP support
  77.        site, or from me. The current version is KIS_V101.ZIP (15k).
  78.  
  79.        PolyXarc is only needed if you install the GET-DIZX.COM version of
  80.        GET-DIZ. PolyXarc is a universal archiver which handles ZIP, ARJ,
  81.        LZH PAK, DWC, ZOO, etc. It still requires that you have the actual
  82.        archive programs as well.
  83.        You can freq. or download the latest PolyXarc from me. I currently 
  84.        have version 21a for DOS: PXDOS21A.ZIP (37k).
  85.  
  86. ┌─────────────────────────────────────────────────────────────────────────────┐
  87. │ ▒▒▒▒  Why 3 versions? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  88. └─────────────────────────────────────────────────────────────────────────────┘
  89.  
  90.        There are three differnt versions of GET-DIZ include in this archive.
  91.        You only need to use one of them. Which one you use depends on whether
  92.        your BBS converts all files to ZIP, ARJ or if you keep several types.
  93.        
  94.        GET-DIZZ.COM - Zip version.  Assumes all files are ZIPs.     
  95.        GET-DIZA.COM - Arj version.  Assumes all files are ARJs.
  96.        GET-DIZX.COM - PolyXarc ver. Allows *ANY* archive type. 
  97.  
  98.        The disadvantage to using the PolyXarc version is that it is slower
  99.        then the direct versions.
  100.        
  101.        I could have just written one version, which was configurable,
  102.        but it was easyer for me this way (it only took afew minutes to
  103.        write), and since the files are only about 1k each, who cares?
  104.        
  105. ┌─────────────────────────────────────────────────────────────────────────────┐
  106. │ ▒▒▒▒  Installing  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  107. └─────────────────────────────────────────────────────────────────────────────┘
  108.  
  109.        To use GET-DIZ, you must have your archivers and KIS.EXE *somewhere*
  110.        in your path. GET-DIZ*.COM itself does not have to be in the path,
  111.        just somewhere on your hard disk (or a RAM Disk).
  112.  
  113.        You must have the %RA% Environment varable set (eg SET RA=C:\RA).
  114.        ***NOTICE!!!*** Do *NOT* have a trailing backslash on the %RA%
  115.        environment variable or GET-DIZ will not work!!!
  116.        
  117.        Run RACONFIG > OPTIONS > FILES > RAMGR-FNKEYS
  118.        
  119.        Change number 2 command line to something like this:
  120.        (shez is just shown as an example, which I use as my file-viewer)
  121.      
  122.        1 c:\shez\shez.exe @ *M
  123.        2 c:\ra\get-dizX.com @
  124.        3 
  125.        4
  126.        5
  127.        
  128.       Notice that GET-DIZ *MUST* be installed in slot #2 (Alt-F2 key).
  129.       >>> ANY POSITION OTHER THEN 2 WILL NOT WORK. <<<
  130.       ************************************************ 
  131.       The reason for this is because it is a self-recursive routine which
  132.       forces RAMGR to call it again for the next file(s) below the cursor.
  133.  
  134. ┌─────────────────────────────────────────────────────────────────────────────┐
  135. │ ▒▒▒▒  Usage  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  136. └─────────────────────────────────────────────────────────────────────────────┘
  137.  
  138.        Once it's installed, run RAMGR -f and select a file area to use.
  139.        Move the cursor to the first file which you wish to process. Press
  140.        Alt-F2 to begin, and RAMGR will call GET-DIZ once for each file
  141.        from there on down.
  142.        So to process an entire area, simply start the cursor at the first
  143.        file (at the top) when you press Alt-F2. If you wish to abort the
  144.        process before it has finished, simply press Ctrl-Break twice.
  145.  
  146.        While its running, PKZIP or ARJ may display File-Not-Found several
  147.        times, which just means that the tested archive did not contain any
  148.        descriptions. This is normal.
  149.  
  150. ┌─────────────────────────────────────────────────────────────────────────────┐
  151. │ ▒▒▒▒  DesqView Limitations  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  152. └─────────────────────────────────────────────────────────────────────────────┘
  153.  
  154.        GET-DIZ runs perfectly under Desqview, but KIS 1.01 has a limitation:
  155.        You can not switch windows while GET-DIZ is running, or elce KIS will
  156.        stuff the keyboard buffer into the new current window.
  157.        
  158.        If you don't like this limitation, there are three things you can do:
  159.        1. Write to the KIS author and ask him to update KIS.
  160.        2. Or find a Keyfaker program that is fully DV compatible and ask me
  161.           to support it instead. :-)
  162.        3. Or delete this package and forget you ever saw it.
  163.  
  164. ┌─────────────────────────────────────────────────────────────────────────────┐
  165. │ ▒▒▒▒  Trouble Shooting ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  166. └─────────────────────────────────────────────────────────────────────────────┘
  167.  
  168.       If you could not get GET-DIZ to work, here's some things to check:
  169.  
  170.       Do *not* have a trailing bakcslash on your %RA% Environment variable.
  171.       Do *not* install it in any slot other then #2 in RACONFIG.
  172.       Do have KIS.EXE in your path, as well as any archivers.
  173.       Do have PolyXarc.EXE in your path, if you are using the get-dizX ver.
  174.          
  175. ┌─────────────────────────────────────────────────────────────────────────────┐
  176. │ ▒▒▒▒  Disclaimer  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  177. └─────────────────────────────────────────────────────────────────────────────┘
  178.  
  179.        GET-DIZ is supplied as *FreeWare*. It only took me about 20 minutes
  180.        to write it, so there is no sence in me charging you money.
  181.        If you really feel this has made your life alot easyer, you could
  182.        send me a small amount (perhaps enough for a 6-pack of beer), but
  183.        you don't have to.
  184.  
  185.        GET-DIZ was tested, and worked flawlessly on my system (3 lines)
  186.        but still, they come with NO Warranty. Use at your own risk!
  187.  
  188.        In no event shall Mike Ehlert or PACIFIC COAST MICRO be liable for
  189.        any damages caused by GET-DIZ. The software is supplied as-is.
  190.        If it crashes your system, then oh well...
  191.  
  192. ┌─────────────────────────────────────────────────────────────────────────────┐
  193. │ ▒▒▒▒  Credits  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  194. └─────────────────────────────────────────────────────────────────────────────┘
  195.  
  196.       Thanks to Andrew Milner, for writing such a fantastic BBS package.
  197.       Thanks to Bruce Bodger, for asking me to become a RA beta tester.
  198.       Thanks to Ron Huskes, for letting me steal his DOC screens.
  199.       Thanks to Rob van Hoeven, for writing Keyboard Input Simulator.
  200.       Thanks to my wife Cindy, for putting up with my BBS Habit.
  201.  
  202. ┌─────────────────────────────────────────────────────────────────────────────┐
  203. │ ▒▒▒▒  GET-DIZ v1.2  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  204. └─────────────────────────────────────────────────────────────────────────────┘
  205.